-
-
Notifications
You must be signed in to change notification settings - Fork 290
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Update live code to live demos in 17-live.md #1558
base: main
Are you sure you want to change the base?
Conversation
ndporter
commented
Jun 9, 2023
- Replace "coding" in most instances with "demo" or related words to make more general
- Update line 33 to reflect both online and in-person workshops
- Remove wikipedia "live coding" link as it refers to live coding as a research or artistic tool, but doesn't reference pedagogy at all
- Added callout on live coding/demos
1. Replace "coding" in most instances with "demo" or related words to make more general 2. Update line 33 to reflect both online and in-person workshops 3. Remove wikipedia "live coding" link as it refers to live coding as a research or artistic tool, but doesn't reference pedagogy at all 4. Added callout on live coding/demos
Thank you!Thank you for your pull request 😃 🤖 This automated message can help you check the rendered files in your submission for clarity. If you have any questions, please feel free to open an issue in {sandpaper}. If you have files that automatically render output (e.g. R Markdown), then you should check for the following:
Rendered Changes🔍 Inspect the changes: https://github.com/carpentries/instructor-training/compare/md-outputs..md-outputs-PR-1558 The following changes were observed in the rendered markdown documents:
What does this mean?If you have source files that require output and figures to be generated (e.g. R Markdown), then it is important to make sure the generated figures and output are reproducible. This output provides a way for you to inspect the output in a diff-friendly manner so that it's easy to see the changes that occur due to new software versions or randomisation. ⏱️ Updated at 2023-08-02 13:14:34 +0000 |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I picked at a few places specifically, but I actually think that we should use "demonstration" throughout because full words are more inclusive than shortenings for non native english speakers, I think.
It's also more consistent to use the exact same term throughout instead of two forms of it.
along. This section explains how it works, why we use it, and | ||
gives general tips for an effective participatory live coding presentation. We will | ||
gives general tips for an effective participatory live demo presentation. We will |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
gives general tips for an effective participatory live demo presentation. We will | |
gives general tips for an effective participatory live demonstration. We will |
"demo presentation" reads funny to me
@@ -174,9 +190,9 @@ This exercise should take about 25 minutes. | |||
|
|||
:::::::::::::::::::::::::::::::::::::::: keypoints | |||
|
|||
- Live coding forces the instructor to slow down. | |||
- Live demos forces the instructor to slow down. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
- Live demos forces the instructor to slow down. | |
- Live demonstration forces the instructor to slow down. |
or live demo maybe, but "live demos" feels like a mismatch of plurality?
@@ -107,7 +123,7 @@ Many error messages are obscure and not written with novices in mind. Continue t | |||
|
|||
## Compare and Contrast | |||
|
|||
Watch this first participatory live coding demo video: [https://youtu.be/bXxBeNkKmJE][live-coding-bad] | |||
Watch this first participatory live demo video: [https://youtu.be/bXxBeNkKmJE][live-coding-bad] |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
this is actually code, so I think here, live "coding" is actually more accurate and we should augment the exercise with reflection on what we can learn from this that applies to non-coding contexts
and continuous feedback (their code either works or fails with an error message). It is | ||
Live demos fits well into the practice-feedback model we have been discussing - by providing | ||
learners with continuous opportunities for practice (every time they type a line of code or perform a procedure) | ||
and continuous feedback (their attempt either works or fails with an error message). It is |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
the "error message" part may not translate to non-coding contexts, but i'm not sure what the best fix is here.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Error messages defnitely come up in non-coding contexts IME.
Live coding fits well into the practice-feedback model we have been discussing - by providing | ||
learners with continuous opportunities for practice (every time they type in a line of code) | ||
and continuous feedback (their code either works or fails with an error message). It is | ||
Live demos fits well into the practice-feedback model we have been discussing - by providing |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Live demos fits well into the practice-feedback model we have been discussing - by providing | |
Live demonstration fits well into the practice-feedback model we have been discussing - by providing |
i think using the full work is better for non native english speakers, but would accept the singular of the shortcut
@brownsarahm - I am internally amused about people reading "live demo" and then expecting to see "Carpentries Live Demolitions", but your suggestion is excellent! |
but you don't need to be a programmer or know how to code at all | ||
to integrate live demonstrations in your teaching. | ||
Many of our lessons on tools like spreadsheets and OpenRefine | ||
include no coding at all, and similar models are widely used |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This is not entirely correct, although I see the distinction of these two lessons. Both use some use of functions. Might change it to "Some lessons might not include coding..."
Following today's discussion in the trainer meeting, my consideration into this change comes to this: |
The reason I don't fully agree with this is that we do, in fact, have quite a bit of curriculum that does not involve coding. The open refine and spreadsheet lessons in the DC and LC curricula, at least. I would even go so far as to say that the Git lessons don't strictly speaking teach coding, but rather interactively interacting with Git on the command line. The point, as I understand it, is not to avoid the word "coding" because it might be unfamiliar or intimidating, but to specifically be inclusive of people who are teaching those lessons, and to avoid confusion by making it clear that the live participatory stuff that we do is not limited to coding. |
I really appreciate @ragamouf's comment
I propose that we take a careful read through how we are framing things in this episode that we always do "participatory live demonstration" and that it is mostly "participatory live coding". We want to include people who want to teach data organization in spreadsheets or cleaning with openrefine, but not affirm people's fear of coding. We teach in this lesson about meeting our learners where they are and encouraging them to use these tools even if they are afraid, I think we need to keep modeling that here. |